home *** CD-ROM | disk | FTP | other *** search
- *************************************************************************
- * DUP-BLOC.PPE *
- * A PCBoard 15 Sysop Utility PPE *
- * version: 1.0 date: 5/9/1994 *
- * (c) Copyright 1994 A. Segura/Fax~An~Ad Marketing, Inc. *
- *************************************************************************
-
-
- Purpose: To improve your BBS SECURITY by performing a Caller-ID
- (CID) phone number check on the newuser against a file of
- existing user CallerID numbers to prevent the user from
- logging on under multiple/duplicate names/records. Used
- in conjunction with CALLBLOC.PPE ver. 2.5 (or greater) for
- callbloc's additional error-checking and recall capabilities.
-
-
- Features: 1. Extremely user (Sysop) configurable!
- 2. Performs limited error and self-integrity checks!
- 3. Sends messages to designated Sysop for detected callers!
- 4. Allows security, language and graphics extension
- text display file!
- 5. All display and message files are user editable!
- 6. Can be placed in ANY directory!
- 7. Built-in Defaults option for increased speed!
- 8. Allows user-defined modem type!
-
- And on, and on, and on........
-
-
- NOTE: Due to the extensive revision of CALLBLOC
- version 2.x, VULGARID version 1.x will not
- function properly with CALLBLOC 2.x. IF you
- are using or desire to use VULGARID, then
- you must install VULGARID version 2.x.
-
-
- Additional
- Requirements: 1. PCBoard version 15.x.
- 2. Caller-ID capable modem (such as Supra or ZyXEL).
- 3. Caller-ID service from local phone company.
-
- NOTE: You do not need any other external
- Caller-ID box/device!!
-
-
- Zip File
- Contents: 1. DUP-BLOC a sample duplicate caller text display file.
- 2. DUP-BLOC.NUM a sample phone number file.
- 3. DUP-MSG a sample bad call sysop message text file
- 4. DUP-BLOC.CFG the configuration file for DUP-BLOC.PPE
- 5. DUP-BLOC.DOC this file.
- 6. DUP-BLOC.PPE the subject PPE file.
- 7. FILE_ID.DIZ a brief BBS text description of this item.
-
-
-
- Overview: The remainder of this document is structured as follows:
-
- 1. Installation Usage - describes how to install the PPE
- in simple terms.
- 2. CFG File Function - describes the configuration file.
- 3. PPE Execution - describes how the PPE runs and
- functions.
- 4. CALLER log entries - describes the various entries the
- PPE will make to the PCB CALLER log.
- 5. Support Files - briefly describes the various text
- display and associated support
- files.
- 6. Registration - NONE!! FREE!!
- 7. Updates - describes How/where to obtain
- updates.
- 8. Source code - describes how to obtain the source
- code.
- 9. Distribution - talks about it.
- 10. Disclaimer - attorney said I had to have it.
- 11. Development History - talks about it.
- 12. Other PPEs - other PPEs I have available.
-
-
-
- Installation
- Usage: A. Determine the directory in which you desire to place
- the PPE and its support files. They may be placed in
- any directory as long as all the files go there. I
- suggest making a directory \PCB\PPE\DUP-BLOC and
- then just unzip DUP-BLOC.ZIP in the DUP-BLOC directory,
- but again, any directory will work.
-
- B. Next, install the PPE in PCBTEXT record #123:
-
- Step 1: Go to your \PCB directory and
- run program MKPCBTXT.EXE, at the
- file request prompt answer with
- the path/name to your PCBTEXT
- file (probably just enter
- PCBTEXT).
-
- Step 2: MKPCBTXT display screen should
- now appear, Depress F3 key.
-
- Step 3: Answer the prompt with: 123
-
- Step 4: The text prompt display will
- now appear.
-
- NOW, edit the field with the
- path/name of the PPE, such as:
- !C:\PCB\PPE\DUP-BLOC\DUP-BLOC.PPE.
- Don't forget the ! character, it
- is mandatory to cause PCBoard to
- recognize and execute a PPE.
-
- Step 5: Now just save and exit MKPCBTXT.
-
- Step 6: Next and Last, go to the direc-
- tory containing the DUP-BLOC files
- and edit the configuration file
- (DUP-BLOC.CFG) to your desire,
- see the CFG file description
- below for info. Also, you may
- edit the other text display files
- as you desire.
-
-
- C. If your PCBoard modem initialization string does not
- already have CallerID function turned-on, then that
- must be done also.
-
- The PPE obtains the Caller-ID info directly from PCBoard
- software, not the modem itself, so, PCBoard software must
- be set to answer on the 2nd ring and the modem CallerID
- enable command must be placed in the PCBoard modem
- Initialization string or similar setup. (i.e. if PCBoard
- is writing the CallerID info in your CALLER log, then
- the setup is OK, if it isn't, then you must get PCBoard
- and CallerID working first).
-
- NOTES: a. for Supra modems, add the #CID=1 command to
- the modem init string. Also, some sysops
- have reported having to set S110=3 to get
- 14400baud connections. (To perform this, run
- PCBSETUP, at Main Menu, select Modem Informa-
- tion, Modem Setup, Modem Initialization String).
-
- b. To set answer on 2nd ring, run PCBSETUP, at
- Main Menu, select Modem Information, Config-
- uration Switches, Number of Rings Required: 2.
-
- c. To enable PCBoard writing of CID info to
- CALLER log, run PCBSETUP, at Main Menu, select
- Configuration Options, Logging Options, Log
- Connect String to Disk: Y.
-
-
-
- CFG File Function: The DUP-BLOC.CFG file provides the Sysop with the
- capability to customize and select options for
- DUP-BLOC.PPE to perform. Below is a sample of
- the configuration file and the entry descriptions:
-
- CFG file Built-in Defaults
- ---------------------------- -------------------------------
-
- Line 1 1 1
- Line 2 SYSOP SYSOP
- Line 3 10 10
- Line 4 1 1
- Line 5 0 1
-
- ---------------------------- -------------------------------
-
-
- Line 1: String indicating modem type (1, 2 or prefix string) 1=Supra or
- Practical Peripherals modem, 2=ZyXEL modem, or the phone
- number actual prefix string for other modem types.
-
- For example, Supra CID string is as follows:
-
- CID: DATE = 0108 TIME = 0630 NMBR = 7034509456
-
- Therefore, the Supra modem prefix is "NMBR = ". However,
- the PPE knows this if you just enter a "1". But this
- example is provided for those that have a different CID
- string. The CID string can be seen in the PCB CALLER log.
-
- Line 2: Addressee (Sysop or Co-Sysop) for Dup call alert message.
-
- Line 3: The number of digits in your local CallerID service, usually
- 10, but someplaces 7 digits.
-
- Line 4: The security level to downgrade the offending user to.
-
- Line 5: Flag to indicate whether to allow automatic updating of
- DUP-BLOC.NUM file with number of every newuser to prevent
- future duplicate logons. (1= enable automatic update, 0= Sysop
- must make manual entries).
-
- If you desire a faster execution (no disk read access slowdown),
- you can activate the built-in defaults simply by either deleting
- the DUP-BLOC.CFG file or renaming it to something else, i.e.
- READ.CFG.
-
-
- NOTE: You must review and edit the CFG file for
- your system and desires.
-
-
-
- PPE Execution: 1. The DUP-BLOC.PPE starts execution by displaying
- the text display message "... Searching Phone
- Records ...". However, if the DUP-BLOC.NUM file is
- missing, instead of the previous message, a message
- "...TELL SYSOP DUP-BLOC.NUM file is missing!" is
- displayed and the PPE terminates, returning to normal
- PCBoard user login function.
-
- 2. Next, the PPE performs a simple self-check of DUP-BLOC.NUM
- file to make certain it is a valid file. If the check
- passes, the text message "..CallerID file integrity
- passed..." is displayed on the local BBS display only.
- The check is fairly simple, the first record (entry)
- in the file must be '1234567890'. So, you must always
- leave the first line that way. This is just an extra
- measure to make sure there are no accidental lock-outs
- due to a corrupted file.
-
- If the check fails, a text message "CallerID file
- integrity FAILED!" is displayed on the local BBS screen,
- an alarm is sounded at the BBS PC speaker, and the PPE
- terminates and returns to the normal user login.
-
- 3. When the PPE detects a match, an entry is made in the PCB
- CALLER log file and a message is sent to the Sysop and the
- user is downgraded to the configured level.
-
- 4. When the PPE completes, the message "DUP-BLOC Successfully
- Completed!" is displayed on the local screen only.
-
-
-
- CALLER log entries: Listed below are examples of entries that DUP-BLOC
- can make to the PCB CALLER log:
-
- 1. 'No CALLERID info available! (DUP-BLOC.PPE)' -
- indicates CID data was not read for some
- reason, perhaps a poor phone line connection
- or CID command not active for modem or a
- non-CID capable modem.
-
- 2. 'DUP-BLOC.PPE using built-in defaults' - the
- DUP-BLOC.CFG file does not exist so PPE has
- switched to built-in defaults.
-
- 3. 'Verify proper CID Key for your modem!
- (DUP-BLOC.PPE)' - CID prefix key selected is
- not correct or very bad phone line.
-
- 4. 'Can't find file DUP-BLOC.NUM! (DUP-BLOC.PPE)'
-
- 5. 'CallerID file integrity FAILED! (DUP-BLOC.PPE)' -
- The first line entry in file DUP-BLOC.NUM is bad.
-
- 6. 'DUP-BOY called again! Check Log..(DUP-BLOC.PPE) -
- indicates a match was found.
-
-
- Support Files:
-
- 1. You must create two files (samples already made in the zip).
- One file named 'DUP-BLOC.NUM' which contains the known bad
- phone numbers to block, one number per line, followed by a
- remark line. The number line format is '2024307269' (only
- the actual number!--or, whatever the format of your caller-id
- service number string). See the example file, it is fairly
- simple. The first entry in the file is an integrity check,
- as described in PPE Execution, paragraph #2 above, so do not
- edit this line. Make sure there are NO blank lines, includ-
- ing a last line, in the file.
-
- The second file is called 'DUP-BLOC' (again, an example
- file is provided). This file is the text display file to be
- shown to the offender. Obviously, it can be edited to your
- preference. PCB text file extensions for Language, Security
- and Graphics are recognized.
-
- 2. DUP-MSG is the text incorporated into the message to the
- Sysop when a bad caller match is detected. Edit it as
- desired.
-
-
-
- Registration: NONE!! There is no registration fee. Basic use of the PPE
- is FREE!!!
-
- However, if you feel compelled that my work is worth
- compensation, I will accept all offers. Thank You!
-
- Also, if you would like to provide suggestions for
- improvement to the PPE, bug reports, or just a note
- of thanks or hello, please forward those as well. See
- below for my mailing address and BBS number. Additionally,
- I frequently browse the RIME Sysop and PCBoard conferences,
- although contacting me there is not as reliable because
- sometimes I get too busy to call.
-
-
- Updates: The latest version of the PPE program can be obtained from
- my BBS: SBG Online! BBS (703) 450-9456. If you have any
- comments or suggestions for improvement, you can leave them
- there also. The file will be found in directory #1 as a
- FREE/NOTIME file. The BBS runs PCBoard 15 at 14400v42bis.
-
-
- Source If you desire a diskette containing the PPL source code so
- Code: you can modify it for your own use, the cost is $15 US. I
- accept cash, money order, VISA or Mastercard. You can place
- an order online on the BBS (703) 450-9456 or by mail at:
- A. Segura, P.O. Box 1089, Sterling, VA, 20167-1089.
-
- EXTRA, EXTRA!! In addition to the DUP-BLOC source, you
- will also receive source to a "Last TEN Caller" and
- "Running Log Caller" bulletin generators that I have
- developed as well.
-
- As another option, for $25, you can subscribe to the PPE
- conference on my BBS. The conference will always contain
- the latest version of the source code for CALLBLOC, DUP-BLOC,
- CALLERID, VULGARID and several other PPEs for immediate
- downloading. The subscription period lasts one year. We
- also have the latest version of the PIER Shareware CDROM
- always online. You can even subscribe online with your
- VISA/MC via (S)cript Questionaire #2 for immediate access.
-
-
- Distribution: You may freely distribute this complete package only in an
- unmodified form. No remuneration may be collected or charged
- for this work by anyone other than the below noticed
- individual/company except for that cost incurred in actual
- electronic media production (i.e. diskette or CDROM). In
- other words, it can be placed on BBSs, shareware CDROMS, etc.
- but I/my company reserves the right of copyright and
- remuneration for the actual work. The source code MAY NOT
- be distributed by anyone other than the below listed company.
-
-
- Disclaimer: The user agrees when utilizing this package that he does so
- at his own risk with no guarantees, implied or otherwise, as
- to the functional performance or liability of the package.
-
-
- Development
- History: ver. date remarks
- ---- -------- ---------------------------------------
- 1.0 05/09/94 Initial release.
-
-
- ***************************************************************************
- * (c) Copyright 1993 A. Segura/Fax~An~Ad Marketing, Inc. *
- ***************************************************************************
-
-
- Other PPEs:
-
- ********************************************************************
- * Look for these other fine utilities at a BBS near you *
- ********************************************************************
-
- AUTOSUBS.PPE run as a script questionnaire, allows online credit
- card subscriptions to BBS (VISA/MC), completes log
- entries and sends alert message to SysOp. (for
- PCBoard 15)
-
- ALLCALL.PPE generates a text display bulletin, complete with PCB
- color codes, of all the callers to the board.
-
- ALLSTAT.PPE generates a text display bulletin, complete with PCB
- color codes, of statistics of all the callers to the board.
-
- BULLCHK.PPE performs automated tracking of bulletins read by the
- user and performs a user upgrade when all sysop selected
- bulletins have been read.
-
- CALLERID.PPE performs basic callerid identification, logs info
- in file log and user records if desired, and will
- also display desired text screens to users--must
- have callerid capable modem. Several SysOp config-
- uable options. (for PCBoard 15)
-
- CALLBLOC.PPE performs a call blocking function before the
- user can log on based upon a SysOp defined listing
- of undesirable phone numbers--must have callerid
- capable modem. Even sends the SysOp an alert message.
- (for PCBoard 15)
-
- DUP-BLOC.PPE Blocks current users from signing-on with duplicate
- records--uses CallerID info. Should be used with
- CALLBLOC.PPE for complete blocking system.
-
- MAKEBLTN.EXE Top callers, cities, down/uploaders bulletin generator
-
- PADLOADS.EXE Automated uploads directory padder--makes your BBS look
- more active with more daily uploads.
-
- REPORT.EXE Program generates reports of CallerID info, user record
- phone numbers, common passwords and several other goodies
- to aid Sysop in identifying abusive or questionable users.
-
- VULGAR.PPE performs a vulgar word/phrase check on user names and
- city entries based on a file of names defined by
- SysOp, and performed before complete newuser login.
- (for PCBoard 15)
-
- VULGARID.PPE same program as VULGAR.PPE except it automatically
- passes the callerid info to CALLBLOC.PPE program
- for future lock-outs. (must have both programs and a
- modem that supports callerid) (for PCBoard 15)
-
- NOTE: VULGARID ver. 1.x only works with CALLBLOC
- ver. 1.x. VULGARID ver. 2.x only works
- with CALLBLOC ver. 2.x.
-
- ***************************************************************************
- * (c) Copyright 1993 A. Segura/Fax~An~Ad Marketing, Inc. *
- ***************************************************************************
-